home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / util / cli / BinHex.readme < prev    next >
Encoding:
Text File  |  1999-09-06  |  5.3 KB  |  113 lines
  1. Short:    V1.19 edit HEX data in your ASCII editor
  2. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  3. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  4. Version:  1.19
  5. Type:     util/cli
  6. Kurz:     Editieren von HEX-Daten mit ASCII Editor
  7.  
  8. This program has nothing to do with binhex transfer protocol.
  9.  
  10. This program converts data (for example program code) into the hexadecimal
  11. data system. This data could be edited with your favorite ASCII text
  12. editor. After that you can convert the data back to their old style. So you
  13. do not need a special hexadecimal editor and you will also be able to
  14. delete, insert parts of the file and things like that. Most hexadecimal
  15. editors only allow to change given data byte for byte.
  16.  
  17. Be sure you know what you are doing! To insert some data into program code
  18. most time crashes the program, because the internal addresses are now
  19. illegal. But the ability to delete data is useful for removing start code
  20. from modules, pictures or text.
  21.  
  22. BinHex needs OS 37 (2.0) or later OS versions!
  23.  
  24. USAGE:
  25.   BinHex BIN/A,HEX/A,MAKEBIN/S,ONLYDATA/S,ROWS/N,ASMDATA/S,CDATA/S,
  26.        REV=REVERSED/S,SIZE/N
  27.   BIN      give filename for original data file
  28.   HEX      give filename for hexadecimal data
  29.   MAKEBIN  set program to convert HEX to BIN (else BIN to HEX)
  30.   ONLYDATA add no ASCII output and no position info to hex data file
  31.   ROWS       give number of rows in one line (1 row = 4 byte)
  32.   ASMDATA  creates a field of ASM DC.x lines (not convertable back to bin).
  33.   CDATA    creates a C style array of data (not convertable back to bin).
  34.   REVERSED converts HEX format, where groups of bytes are in reverse
  35.          order (at the moment only in HEX->BIN mode)
  36.   SIZE     1) for ASMDATA and CDATA (1 = Byte, 2 = Word, 4 = Longword)
  37.          2) for REVERSED : gives size of REVERSED data (default = 16)
  38.   NOTAB    Some editors automatically expand tab stops into spaces (for
  39.        example standard editor C:ED). Use this option for these
  40.        editors together with MAKEBIN. Now BinHex accepts $ as line end
  41.        instead of \t (tab stop) as well.
  42.   NOASCII  like ONLYDATA, but includes the space characters in number body
  43.  
  44. The options ASMDATA and CDATA create an output useable in an assembler or
  45. C compiler. If you choose SIZE 2 or 4 and the file does not end at WORD or
  46. LONG boundaries, at the end zeros are added till the boundary.
  47.  
  48. To make it impossible to overwrite binary data if not wanted use every time
  49. one of the BIN or HEX keywords, but they are not needed!. «BinHex A B» is
  50. same as «BinHex A HEX B», but the second is saver.
  51.  
  52. hexadecimal data format:
  53.   In the hexadecimal file the data is interpreted from begin of line to next
  54.   tab stop (\t, $09). If there is no tab stop in the line it is done from
  55.   begin of line to next return (\n, $0A). All other parts and spaces are
  56.   ignored! With NOTAB option a line may end with $ (the start character of
  57.   address) as well.
  58.   If there is a \ in the data part all following characters to the next
  59.   tab stop (or return) are not converted. They are taken like given (good
  60.   for inserting readable text).
  61.  
  62. dir
  63.   example 1:
  64.   BIN data in RAM:A       Hello World!
  65. call BinHEX RAM:A HEX RAM:B ONLYDATA
  66.   HEX data in RAM:B       48656C6C6F20576F726C6421
  67.  
  68.   example 2:
  69.   HEX data in RAM:B      4865 6C6c 6f20\World!
  70. call BinHEX RAM:A HEX RAM:B MAKEBIN
  71.   BIN data in RAM:A       Hello World!
  72.  
  73. Please report me bugs, comments, suggestions and problems. If possible
  74. write a little mail if you use the program sometimes. If there are some
  75. Enforcer hits or other problems report them as good as possible.
  76.  
  77. Do not forget BinHex including source is Public Domain! I hope some more
  78. programmers follow the PD/Freeware idea. Shareware is good, but why pay
  79. for example 20$ for a very little utility?
  80.   
  81. Use it as you want, but WITHOUT ANY WARRANTY!
  82.  
  83. Please contact me:
  84.  
  85. ************************************************************************
  86. * snail-mail:                  * e-mail:                               *
  87. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  88. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  89. *   01877 Bischofswerda        * world wide web:                       *
  90. *   GERMANY                    *   http://home.pages.de/~Gremlin/      *
  91. * phone:                       * pgp key:                              *
  92. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  93. ************************************************************************
  94.  
  95.  
  96. ============================= Archive contents =============================
  97.  
  98. Original  Packed Ratio    Date     Time    Name
  99. -------- ------- ----- --------- --------  -------------
  100.     5200    3277 36.9% 04-Jul-99 17:08:32  BinHex
  101.     4467    2056 53.9% 04-Jul-99 17:08:24  BinHex.readme
  102.    11043    3902 64.6% 04-Jul-99 17:08:28 +BinHex.c
  103.      440     250 43.1% 04-Jul-99 17:09:02 +SDI_ASM_functions.lib
  104.     1251     576 53.9% 04-Jul-99 17:09:16 +SDI_ASM_protos.h
  105.     2188     805 63.2% 04-Jul-99 17:09:02 +SDI_ASM_STD_functions.lib
  106.     5632    1977 64.8% 04-Jul-99 17:09:16 +SDI_ASM_STD_protos.h
  107.     3567    1568 56.0% 04-Jul-99 17:09:16 +SDI_defines.h
  108.     2448    1076 56.0% 04-Jul-99 17:09:22 +SDI_functions.o
  109.     2537    1033 59.2% 04-Jul-99 17:09:16 +SDI_protos.h
  110.      618     359 41.9% 04-Jul-99 17:09:16 +SDI_structures.h
  111. -------- ------- ----- --------- --------
  112.    39391   16879 57.1% 12-Jul-99 04:37:32   11 files
  113.